home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmeConvertMerge.z
/
XmeConvertMerge
Wrap
Text File
|
1998-10-30
|
9KB
|
133 lines
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee - A toolkit function that merges data
converted during a transfer operation
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/Xm.h>
vvvvooooiiiidddd XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(
XXXXttttPPPPooooiiiinnnntttteeeerrrr ddddaaaattttaaaa,
AAAAttttoooommmm ttttyyyyppppeeee,
iiiinnnntttt ffffoooorrrrmmmmaaaatttt,
uuuunnnnssssiiiiggggnnnneeeedddd lllloooonnnngggg lllleeeennnnggggtttthhhh,
XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt ****ccccaaaallllllll____ddddaaaattttaaaa);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee merges data converted in the course of a
transfer operation. The data to be merged is typically two
list of targets. An XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure in an
application may supply some elements of the list, and the
ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method of a widget may supply others.
Therefore, the ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method will need to call
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee to merge the two target lists.
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee can only be called from an
XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure or from a ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait
method.
A ccccoooonnnnvvvveeeerrrrttttPPPPrrrroooocccc trait method usually calls XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeeewhen
an XXXXmmmmNNNNccccoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkk procedure returns an
XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt structure containing a _s_t_a_t_u_s of
XXXXmmmmCCCCOOOONNNNVVVVEEEERRRRTTTT____MMMMEEEERRRRGGGGEEEE.
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee uses XXXXttttRRRReeeeaaaalllllllloooocccc to increase the allocated
storage for the _v_a_l_u_e member of the
XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuuccccttttpassed in the _c_a_l_l__d_a_t_a argument. It
then appends _d_a_t_a to the data already present in the _v_a_l_u_e
member. The _t_y_p_e and _f_o_r_m_a_t passed as arguments to
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeeemust match the _t_y_p_e and _f_o_r_m_a_t fields passed
in the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt.
_d_a_t_a Specifies the data to be added to the _v_a_l_u_e member
of the callback struct.
_t_y_p_e Indicates the type of _d_a_t_a.
_f_o_r_m_a_t Specifies how the call should interpret _d_a_t_a. You
must specify 8, 16, or 32. A value of 8888 implies
that _d_a_t_ais an array of _c_h_a_r. A value of 11116666
implies that _d_a_t_a is an array of _s_h_o_r_t. A value of
33332222 implies that _d_a_t_a is an array of _l_o_n_g. It is
Page 1 (printed 10/24/98)
XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee((((3333XXXX)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee((((3333XXXX))))
possible that the specified number may not match
the actual number of bits passed in _d_a_t_a. For
example, a value of 32 may actually correspond to
a 64-bit data structure on some machines.
_l_e_n_g_t_h Specifies the number of elements in _d_a_t_a, where
each element has the number of bits specified by
_f_o_r_m_a_t.
_c_a_l_l__d_a_t_a Specifies a pointer to the XXXXmmmmCCCCoooonnnnvvvveeeerrrrttttCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt
that is to be modified.
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3),
XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3),
XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3),
XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3),
XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3),
XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3), XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3), and
XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3).
Page 2 (printed 10/24/98)